home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3c / realpath.z / realpath
Encoding:
Text File  |  1998-10-20  |  3.2 KB  |  67 lines
  1.  
  2.  
  3.  
  4. rrrreeeeaaaallllppppaaaatttthhhh((((3333CCCC))))                                                      rrrreeeeaaaallllppppaaaatttthhhh((((3333CCCC))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _rrrr_eeee_aaaa_llll_pppp_aaaa_tttt_hhhh - returns the real file name
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_tttt_dddd_llll_iiii_bbbb_...._hhhh_>>>>
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_pppp_aaaa_rrrr_aaaa_mmmm_...._hhhh_>>>>
  14.  
  15.      _cccc_hhhh_aaaa_rrrr _****_rrrr_eeee_aaaa_llll_pppp_aaaa_tttt_hhhh _((((_cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_ffff_iiii_llll_eeee______nnnn_aaaa_mmmm_eeee_,,,, _cccc_hhhh_aaaa_rrrr _****_rrrr_eeee_ssss_oooo_llll_vvvv_eeee_dddd______nnnn_aaaa_mmmm_eeee_))))_;;;;
  16.  
  17. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      _rrrr_eeee_aaaa_llll_pppp_aaaa_tttt_hhhh resolves all links, symbolic links, and references to ``.'' and
  19.      ``..'' in _f_i_l_e__n_a_m_e and stores it in _r_e_s_o_l_v_e_d__n_a_m_e.
  20.  
  21.      It can handle both relative and absolute path names.  For absolute path
  22.      names and the relative names whose resolved name cannot be expressed
  23.      relatively (for example, _...._...._////_...._...._////_rrrr_eeee_llll_dddd_iiii_rrrr), it returns the _r_e_s_o_l_v_e_d _a_b_s_o_l_u_t_e
  24.      name.
  25.  
  26.      _r_e_s_o_l_v_e_d__n_a_m_e should point to a buffer (_MMMM_AAAA_XXXX_PPPP_AAAA_TTTT_HHHH_LLLL_EEEE_NNNN) bytes in length to
  27.      contain the fully resolved path name.
  28.  
  29. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  30.      _gggg_eeee_tttt_cccc_wwww_dddd(3C).
  31.  
  32. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  33.      If there is no error, _rrrr_eeee_aaaa_llll_pppp_aaaa_tttt_hhhh returns a pointer to the _r_e_s_o_l_v_e_d__n_a_m_e.
  34.      Otherwise it returns a null pointer and places the name of the offending
  35.      file in _r_e_s_o_l_v_e_d__n_a_m_e.  The global variable _eeee_rrrr_rrrr_nnnn_oooo is set to indicate the
  36.      error.
  37.  
  38. NNNNOOOOTTTTEEEESSSS
  39.      _rrrr_eeee_aaaa_llll_pppp_aaaa_tttt_hhhh operates on null-terminated strings.
  40.  
  41.      One should have execute permission on all the directories in the given
  42.      and the resolved path.
  43.  
  44.      _rrrr_eeee_aaaa_llll_pppp_aaaa_tttt_hhhh may fail to return to the current directory if an error occurs.
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.